home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / Tcl-Tk 8.0 / Pre-installed version / tcl8.0 / win / README < prev    next >
Encoding:
Text File  |  1997-08-15  |  4.0 KB  |  114 lines  |  [TEXT/ALFA]
  1. Tcl 8.0b2 for Windows
  2.  
  3. by Scott Stanton
  4. Sun Microsystems Laboratories
  5. scott.stanton@eng.sun.com
  6.  
  7. SCCS: @(#) README 1.23 97/08/13 18:54:48
  8.  
  9. 1. Introduction
  10. ---------------
  11.  
  12. This is the directory where you configure and compile the Windows
  13. version of Tcl.  This directory also contains source files for Tcl
  14. that are specific to Microsoft Windows.  The rest of this file
  15. contains information specific to the Windows version of Tcl.
  16.  
  17. 2. Distribution notes
  18. ---------------------
  19.  
  20. Tcl 8.0 for Windows is distributed in binary form in addition to the
  21. common source release.  The binary distribution is a self-extracting
  22. archive with a built-in installation script.
  23.  
  24. Look for the binary release in the same location as the source release
  25. (ftp.smli.com:/pub/tcl or any of the mirror sites).  For most users,
  26. the binary release will be much easier to install and use.  You only
  27. need the source release if you plan to modify the core of Tcl, or if
  28. you need to compile with a different compiler.  With the addition of
  29. the dynamic loading interface, it is no longer necessary to have the
  30. source distribution in order to build and use extensions.
  31.  
  32. 3. Compiling Tcl
  33. ----------------
  34.  
  35. In order to compile Tcl for Windows, you need the following items:
  36.  
  37.     Tcl 8.0 Source Distribution (plus any patches)
  38.  
  39.     Borland C++ 4.52 (both 16-bit and 32-bit compilers)
  40.       or
  41.     Visual C++ 2.x/4.x
  42.     Visual C++ 1.5 (to build tcl1680.dll for Win32s support of exec)
  43.  
  44. In the "win" subdirectory of the source release, you will find two
  45. files called "makefile.bc" and "makefile.vc".  These are the makefiles
  46. for the Borland and Visual C++ compilers respectively.  You should
  47. copy the appropriate one to "makefile" and update the paths at the
  48. top of the file to reflect your system configuration.  Now you can use
  49. "make" (or "nmake" for VC++) to build the tcl libraries and the tclsh
  50. executable.
  51.  
  52. In order to use the binaries generated by these makefiles, you will
  53. need to place the Tcl script library files someplace where Tcl can
  54. find them.  Tcl looks in one of three places for the library files:
  55.  
  56.     1) The path specified in the environment variable "TCL_LIBRARY".
  57.  
  58.     2) In the lib\tcl8.0 directory under the installation directory
  59.        as specified in the registry:
  60.  
  61.         For Windows NT & 95:
  62.             HKEY_LOCAL_MACHINE\SOFTWARE\Sun\Tcl\8.0
  63.             Value Name is "Root"
  64.  
  65.         For Win32s:
  66.             HKEY_CLASSES_ROOT\SOFTWARE\Sun\Tcl\8.0\
  67.  
  68.     3) Relative to the directory containing the current .exe.
  69.         Tcl will look for a directory "..\lib\tcl8.0" relative to the
  70.         directory containing the currently running .exe.
  71.  
  72. Note that in order to run tclsh80.exe, you must ensure that tcl80.dll
  73. and tclpip80.dll (plus tcl1680.dll under Win32s) are on your path, in
  74. the system directory, or in the directory containing tclsh80.exe.
  75.  
  76. 4. Test suite
  77. -------------
  78.  
  79. This distribution contains an extensive test suite for Tcl.  Some of
  80. the tests are timing dependent and will fail from time to time.  If a
  81. test is failing consistently, please send us a bug report with as much
  82. detail as you can manage.
  83.  
  84. In order to run the test suite, you build the "test" target using the
  85. appropriate makefile for your compiler.
  86.  
  87.  
  88. 5. Known Bugs
  89. -------------
  90.  
  91. Here is the current list of known bugs/missing features for the
  92. Windows version of Tcl:
  93.  
  94. - Solstice NFS interacts badly with Tcl, files linger after close
  95. - Sockets have been known to hang during high load.  There are still
  96.   some unresolved problems in the socket code where close events may
  97.   get lost.
  98. - Blocking "after" commands (e.g. "after 3000") don't work on Win32s.
  99. - Clock command fails to handle daylight savings time boundaries for
  100.   things like "last week".
  101. - Background processes aren't properly detached on NT.
  102. - File events only work on sockets.
  103. - Pipes/files/console/serial ports don't support nonblocking I/O.
  104. - The library cannot be used by two processes at the same time under
  105.   Win32s.
  106.  
  107. If you have comments or bug reports for the Windows version of Tcl,
  108. please direct them to:
  109.  
  110. Scott Stanton
  111. scott.stanton@eng.sun.com
  112.  
  113. or post them to the comp.lang.tcl newsgroup.
  114.